home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / gldebug.z / gldebug
Text File  |  1998-10-30  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. GGGGLLLLDDDDEEEEBBBBUUUUGGGG((((1111))))                                                          GGGGLLLLDDDDEEEEBBBBUUUUGGGG((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      gldebug - debug utility for GL programs
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ggggllllddddeeeebbbbuuuugggg [----hhhhwwwweeeeffff] [----ccccssss] [----CCCC] [----FFFF] [----pppp wait] [----iiii filename] [----oooo filename]
  13.      [----OOOO] application [ -application options ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ggggllllddddeeeebbbbuuuugggg is an aid for debugging GL programs.  It outputs a trace of GL
  17.      functions and parameters invoked by the program, and performs run-time GL
  18.      error checking of parameters and state, to ensure that the GL is being
  19.      called by the application properly.
  20.  
  21.      Also provided with ggggllllddddeeeebbbbuuuugggg are a Stateviewer and a Controller.  The
  22.      Stateviewer graphically displays the current state of the GL as the
  23.      application is running. The Controller allows the user to interactively
  24.      change the level of debugging output, as well as set breakpoints to stop
  25.      execution at GL calls or at error conditions.
  26.  
  27. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  28.      ----hhhh              no history output.
  29.  
  30.      ----wwww              no warning output.
  31.  
  32.      ----eeee              no error output.
  33.  
  34.      ----ffff              no fatal error output.
  35.  
  36.      ----cccc              do not run Controller.
  37.  
  38.      ----ssss              do not run Stateviewer.
  39.  
  40.      ----CCCC              generate C code in history file.
  41.  
  42.      ----FFFF              flush output buffer to history file after each GL call.
  43.  
  44.      ----pppp _w_a_i_t         profile (output the number of times each GL function is
  45.                      called).  wait is the number of GL calls wait between
  46.                      each profile write to file.  Profile output goes to
  47.                      _G_L_d_e_b_u_g._c_o_u_n_t.
  48.  
  49.      ----iiii _f_i_l_e_n_a_m_e     ignore the GL functions listed in filename when writing
  50.                      output.  filename should contain GL function names listed
  51.                      one per line.
  52.  
  53.      ----oooo _f_i_l_e_n_a_m_e     send history trace output to filename. Default is
  54.                      _G_L_d_e_b_u_g._h_i_s_t_o_r_y.
  55.  
  56.      ----OOOO              send history trace output to stdout. This overrides -o
  57.                      filename.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. GGGGLLLLDDDDEEEEBBBBUUUUGGGG((((1111))))                                                          GGGGLLLLDDDDEEEEBBBBUUUUGGGG((((1111))))
  71.  
  72.  
  73.  
  74. FFFFIIIILLLLEEEESSSS
  75.      /usr/lib/libgd.so        gldebug dynamic shared object
  76.  
  77.      /usr/sbin/gldebug        executable
  78.  
  79.      /usr/sbin/gd_controller  the Controller executable
  80.  
  81.      /usr/sbin/gd_stateview   the Stateviewer executable
  82.  
  83.      /usr/lib/X11/app-defaults/GLdebug
  84.                               the X application defaults for the controller
  85.                               and stateviewer.
  86.  
  87. NNNNOOOOTTTTEEEESSSS
  88.      A program must have been linked with the GL dynamic shared object (DSO),
  89.      IRIX release 5.0 or later, to work with gldebug.  A program linked with
  90.      the shared GL library (-lgl_s), available with previous releases of the
  91.      operating system, will not work with gldebug.
  92.  
  93.      The stateviewer will be disabled when running gldebug on a program that
  94.      is displaying windows on a remote system (ie. the DISPLAY environment
  95.      variable is set to a system other than that which is running the program
  96.      itself).  In this case, a warning message will appear in a menu to
  97.      explain the stateviewer's absence.
  98.  
  99. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  100.      GL Programming Tools and Techniques, GLdebug chapter
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.